Skip to main content

Data Visualizer

This chapter refers to the legacy version of the Data Visualizer.
For the current version, see the new Data Visualizer.

About the Data Visualizer App

Column Chart

The Classic Data Visualizer app lets you select indicators, data elements, periods, and organisation units for analysis.
It works well on poor connections and generates charts in the web browser.

Tips

  • Click series labels in the chart to hide/show them.
  • Use the triple-left-arrow on the top center to collapse the side menu.

Create a Chart

  1. Open the Classic Data Visualizer app and choose a chart type.
  2. Select metadata from all three dimensions:
    • Data (indicators, data elements, reporting rates)
    • Periods (fixed or relative)
    • Organisation units
  3. Click Layout to arrange dimensions.
  4. Click Update to generate the chart.

Note:
Default period type can be changed in:
System Settings → General → Default relative period for analysis.


Select a Chart Type

There are nine chart types:

Chart TypeDescription
Column chartVertical bars for comparison across units.
Stacked columnVertical stacked bars to show sums and trends.
Bar chartSame as column, but horizontal.
Stacked barHorizontal stacked bars.
Line chartTime-series visualization.
Area chartFilled line chart for comparing trends.
Pie chartProportional circular chart.
Radar chartSpider chart showing multivariate data.
Speedometer chartGauge chart (0–100%).

Select the type under Chart type → click Update.


Select Dimension Items

DHIS2 data uses three main dimensions:

  • Data: indicators, data elements, datasets
  • Periods: fixed or relative
  • Organisation units: where the event occurred

You can select items by:

  • Double-click
  • Single-arrow / double-arrow buttons
  • Clearing items from the Selected list

Select Indicators

  1. Click Data → Indicators.
  2. Choose an indicator group.
  3. Double-click indicators to move them to Selected.

Select Data Elements

Same steps as indicators.

Select Reporting Rates

  1. Click Data → Reporting rates.
  2. Double-click rates to add.

Select Fixed & Relative Periods

You may combine both.

  • Fixed periods: select a period type, pick periods.
  • Relative periods: e.g., Last month, Last 12 months.

Select Organisation Units

  1. Click Organisation units.
  2. Select Selection mode:
ModeDescription
Select organisation unitsChoose units from the tree or use user-based shortcuts.
Select levelsSelect all units at a certain hierarchy level.
Select groupsSelect units by group (e.g., hospitals).
  1. Click Update.

Additional Dimensions

Depending on configurations (e.g., age, sex), you may add extra dimensions for analysis.


Series, Category, and Filter

Layout

Use Layout to assign:

  • Series → trends (e.g., periods)
  • Categories → comparison groups (e.g., org units)
  • Filter → restrict data (only 1 item allowed for Data dimension)

Drag and drop, then click Update.


Change Chart Display

Use Options to customize chart appearance.

Option GroupSettingDescription
DataShow valuesDisplay numeric values on chart.
100% stackedNormalize columns to 100%.
CumulativeCumulative line values.
Hide empty categoriesRemove missing-value items.
Trend lineShow performance trend.
Target/Base lineAdd reference lines.
Sort orderSort values ascending/descending.
Aggregation typeCount, Min, Max, etc.
EventsInclude only completed eventsExclude partial events.
AxesMin/Max, ticks, decimals, titlesCustomize axis appearance.
StyleNo space between barsUseful for EPI curves.
GeneralHide title, subtitle, legendClean up visual appearance.

Manage Favorites

Favorites allow saving, sharing, and reusing charts.

Open a Favorite

Go to Favorites → Open and pick one.

Save a Favorite

Favorites → Save as → enter Name and Description.

Rename

Favorites → Rename

Interpretations

Write an interpretation for shared favorites:

  • Supports bold, italic, emojis, mentions (@username), and URLs.

Subscribe

Receive notifications on updates.

Generate links for:

  • Use in the app
  • Web API (JSON, CSV, etc.)

Delete

Favorites → Delete

View Interpretations for Relative Periods

Click interpretation items to load chart with the correct date context.


Download a Chart

Download → Graphics → PNG or PDF


Download Chart Data Source

Download data behind the chart in various formats:

FormatDescription
JSONID-based; also Code/Name supported
XMLID-based; also Code/Name supported
ExcelID/Code/Name
CSVID/Code/Name
JRXMLJasper Report template
Raw SQLSQL used to generate the visualization

Embed Charts in Any Web Page

Share → Embed in web page
Copy the generated HTML snippet.


Open as Pivot Table or Map

In the chart view, click Chart or Map to switch.